home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / sgml / sgml2latex-format.1.3.tar.Z / sgml2latex-format.1.3.tar / test / test.latin1 < prev    next >
Text File  |  1993-03-12  |  12KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                          TThhee qwertz SGML Document Types
  11.                          (Version 1.1 Reference Manual)
  12.  
  13.                                    _T_o_m _G_o_r_d_o_n
  14.                                The qwertz Project
  15.                Institute for Applied Information Technology (F3)
  16.                         German National Research Center
  17.                            for Computer Science (GMD)
  18.  
  19.  
  20.           11..  WWhhyy NNoott JJuusstt UUssee LLaaTTeeXX??
  21.  
  22.           The  qwertz document types are a set of Standard Generalized
  23.           Markup Language (SGML) document type definitions (DTDs)  for
  24.           articles,  reports,  books, letters, notes, slides (or over¡
  25.           head  transparencies),  bibliographies,  and  manual  pages.
  26.           Except  for manual pages, the document types have been heav¡
  27.           ily influenced by the LaTeX document types of the same names
  28.           Lamport86  ,  so  LaTeX  users  should  feel  right at home.
  29.           Indeed, we presently translate most  qwertz  documents  into
  30.           LaTeX  for printing and the LaTeX produced is quite readable
  31.           by anyone familiar with LaTeX.
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           22..  TThhee qwertz Document Type Definition
  74.  
  75.  
  76.              We will be making use of several  _p_a_r_a_m_e_t_e_r  _e_n_t_i_t_i_e_s  in
  77.           this DTD:
  78.  
  79.  
  80.           ____________________________________________________________
  81.           <!entity % emph
  82.                   " em | it | bf | sf | sl | tt " >
  83.  
  84.           <!entity % inline
  85.                   " f | x | %emph; | sq | label | ref |
  86.                     pageref | cite | ncite " >
  87.           ____________________________________________________________
  88.  
  89.  
  90.  
  91.  
  92.  
  93.           22..11..  GGeenneerraall PPuurrppoossee EEnnttiittiieess aanndd EElleemmeennttss
  94.  
  95.  
  96.              When may it be necessary to use of an entity reference to
  97.           produce some character?  There are three cases to watch  out
  98.           for:
  99.  
  100.  
  101.              SSGGMMLL CCoonnccrreettee SSyynnttaaxx DDeelliimmiitteerrss..
  102.                 Although the SGML standard allows alternative concrete
  103.                 syntaxes to be defined, we use the so-called _r_e_f_e_r_e_n_c_e
  104.                 _c_o_n_c_r_e_t_e _s_y_n_t_a_x in the qwertz document types.  ...
  105.  
  106.  
  107.              SSGGMMLL SShhoorrtt RReeffeerreennccee DDeelliimmiitteerrss..
  108.                 In  SGML  document  types  _s_h_o_r_t _r_e_f_e_r_e_n_c_e _m_a_p_s may be
  109.                 defined which allow single  characters  to  be  inter¡
  110.                 preted as arbitrarily complex sequences of characters,
  111.                 including SGML tags and entity references. ...
  112.  
  113.  
  114.                 " # % ' ( ) * + , - : ; = @ [ ] ^ _ { | } ~
  115.  
  116.  
  117.  
  118.              For each of these characters, there  is  an  SGML  entity
  119.              which  may be used to generate the ASCII character in the
  120.              printed document, listed in table ??.  _U_s_u_a_l_l_y_,  _i_t  _w_i_l_l
  121.              _n_o_t _b_e _n_e_c_e_s_s_a_r_y _t_o _u_s_e _t_h_e_s_e _e_n_t_i_t_i_e_s_; _t_h_e _c_h_a_r_a_c_t_e_r _c_a_n
  122.              _s_i_m_p_l_y _b_e _t_y_p_e_d _a_n_d _w_i_l_l _b_e _i_n_t_e_r_p_r_e_t_e_d  _l_i_t_e_r_a_l_l_y_.  How¡
  123.              ever, ...
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                               General Purpose Entities
  137.  
  138.  
  139.              TTeeXX SSppeecciiaall CChhaarraacctteerrss..
  140.                 Ideally, it should be possible to hide the conventions
  141.                 of the underlying formatting  system  completely.   In
  142.                 fact,  SGML parsers which implement the full ISO stan¡
  143.                 dard have a feature which makes this possible. ...
  144.  
  145.  
  146.  
  147.           22..11..11..  SSppaacciinngg,, DDaasshheess aanndd EElllliippssiiss
  148.  
  149.  
  150.              There are also three different kinds  of  dashes:  hyphen
  151.           which  was already mentioned above, is to be used for intra-
  152.           word dashes, as in the word "intra-word".1
  153.  
  154.  
  155.  
  156.           22..11..22..  FFoorreeiiggnn CChhaarraacctteerrss
  157.  
  158.           There are a large set of entities for other Western European
  159.           languages.  Altogether, there are entities for almost all of
  160.           the foreign language characters in ISO  8859,  the  Latin  1
  161.           character set for Western European languages.2  ...
  162.  
  163.                           |            |            |
  164.                AElig    ╞ | Aacute   ┴ | Acirc    ┬ | Ae       ─
  165.                Ntilde   ╤ | Oacute   ╙ | Ocirc    ╘ | Oe       ╓
  166.                Ue       ▄ | Ugrave   ┘ | Uuml     ▄ | Yacute   ▌
  167.                aacute   ß | acirc    Γ | ae       Σ | aelig    µ
  168.                oe       ÷ | ograve   ≥ | oslash   ° | otilde   ⌡
  169.                sz       ▀ | szlig    ▀ | thinsp     | tilde    ~
  170.                times    ╫ | uacute   · | ucirc    √ | ue       ⁿ
  171.  
  172.  
  173.                         (Some) General Purpose Characters
  174.  
  175.  
  176.  
  177.           22..11..33..  SSeenntteenncceess,, PPaarraaggrraapphhss,, FFoooottnnootteess aanndd EEmmpphhaassiiss
  178.  
  179.  
  180.              Sentences  or phrases within paragraphs can be emphasized
  181.           in a number of ways.  The em  tag  is  used  to  choose  the
  182.           default  form of emphasis, which is usually _i_t_a_l_i_c type, but
  183.           depends on the style of the background text.  If  the  back¡
  184.           ground  text  is formatted in italics type, as it usually is
  185.           in definitions, for example, than emphasized  text  will  be
  186.           formatted  using  a plain, roman typeface.  However, various
  187.           -----------
  188.             1. However, the hyphen entity was  not  actually
  189.           necessary  here,  as the - character was not being
  190.           used in this context as a short reference.
  191.             2. Only  the four Icelandic characters are miss¡
  192.           ing.
  193.  
  194.  
  195.  
  196.                                         3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.           The qwertz Document Types
  203.  
  204.  
  205.           forms of emphasis can be explicitly chosen.  These  include:
  206.           bboolldd ffaaccee (bf), _i_t_a_l_i_c_s (it), sans serif (sf), _s_l_a_n_t_e_d (sl),
  207.           and typewriter (tt) styles.
  208.  
  209.  
  210.              Long quotes are formatted in LaTeX by indenting the  left
  211.           and right margins.  For example, Lamport86 (pp. xiii):
  212.  
  213.  
  214.                 The  LaTeX document preparation system is a special
  215.              version of Donald  Knuth's  TeX  program.   TeX  is  a
  216.              sophisticated program designed to produce high-quality
  217.              typesetting, especially for mathematical text.
  218.  
  219.                 LaTeX represents a  balance  between  functionality
  220.              and  ease  of  use.   Since  I  implemented most of it
  221.              myself, there was also a continual compromise  between
  222.              what  I  wanted to do and what I could do in a reason¡
  223.              able amount of time.  ...
  224.  
  225.  
  226.           22..11..44..  LLiissttss
  227.  
  228.           Three types of lists are supported, which  differ  according
  229.           to  the  type  of  label used to mark each item in the list.
  230.           Use itemize to create a list in which each  item  is  marked
  231.           with  some  symbol such as a dash or bullet. The enum tag is
  232.           used to create an enumeration, i.e. a  list  in  which  each
  233.           item  is  labelled  with a number (or letter) indicating its
  234.           rank or position in the list. Finally, use descrip to create
  235.           a  list  in  which each item is labelled by some tag of your
  236.           own choice. Lists of various types can nested.  For example:
  237.  
  238.  
  239.  
  240.           ╖   A level one item.
  241.  
  242.           ╖   Here's level two two
  243.  
  244.              1.  A level two item.
  245.  
  246.              2.  Here's level three:
  247.  
  248.                 a.  A level three item.
  249.  
  250.                 b.  Here's level four:
  251.  
  252.                    RReedd..
  253.                        Is the color of my true love's hair.
  254.  
  255.                    BBlluuee..
  256.                        Is a property of some movies.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                         4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                                                  Lists
  269.  
  270.  
  271.                    YYeellllooww..
  272.                        Characterizes some forms of journalism.
  273.  
  274.                 c. A last level three item
  275.  
  276.              3.  A last level two item
  277.  
  278.           ╖  A last level one item.
  279.  
  280.  
  281.  
  282.           22..11..55..  FFiigguurreess aanndd TTaabblleess
  283.  
  284.           Encapsulated  PostScript  graphics  can  be  created using a
  285.           variety of different editors.  If you are using Unix with an
  286.           X11-based  graphical  user-interface,  you  may  want to try
  287.           idraw, which stores its documents directly  as  Encapsulated
  288.           PostScript files. Another interesting X11-based drawing pro¡
  289.           gram is tgif.
  290.  
  291.  
  292.              Which would then appear as in figure ??.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                                  An idraw Drawing
  300.  
  301.  
  302.           22..11..66..  LLiitteerraattee PPrrooggrraammmmiinngg
  303.  
  304.           The original motivation behind the development of these doc¡
  305.           ument  types  was to create an environment for literate pro¡
  306.           gramming in an arbitrary  programming  language  similar  to
  307.           Donald Knuth's WEB system for literate programming in Pascal
  308.           Knuth84 .  ...
  309.  
  310.              When formatted, spaces and line breaks are preserved:
  311.  
  312.  
  313.           main ()
  314.           {
  315.                   /* This is the famous hello world program */
  316.  
  317.                   printf("hello world\n");
  318.           }
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                         5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.           The qwertz Document Types
  335.  
  336.  
  337.           22..11..77..  MMaatthheemmaattiiccaall FFoorrmmuullaass
  338.  
  339.           The qwertz document types include  elements  for  describing
  340.           mathematical formulas completely within SGML, similar to the
  341.           system described in daphne89 .  ...
  342.  
  343.              So, for example, example,
  344.  
  345.  
  346.                     sum  from {i=1} to {n}x sub {i} =          int  from {0} to {1}f
  347.  
  348.            was typed as:
  349.  
  350.           <dm>
  351.                   <sum><ll>i=1<ul>n<opd>x<inf>i</></sum> =
  352.                   <in><ll>0<ul>1<opd>f</in>
  353.           </dm>
  354.  
  355.  
  356.  
  357.  
  358.              $LIST$
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                         6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                                                  Lists
  401.  
  402.  
  403.                                TTaabbllee ooff CCoonntteennttss
  404.  
  405.  
  406.  
  407.           1. Why Not Just Use LaTeX?   . . . . . . . . . . . . . .   1
  408.  
  409.           2. The qwertz Document Type Definition . . . . . . . . .   2
  410.  
  411.           2.1. General Purpose Entities and Elements . . . . . . .   2
  412.  
  413.           2.1.1. Spacing, Dashes and Ellipsis  . . . . . . . . . .   3
  414.  
  415.           2.1.2. Foreign Characters  . . . . . . . . . . . . . . .   3
  416.  
  417.           2.1.3. Sentences, Paragraphs, Footnotes and Emphasis
  418.            . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  419.  
  420.           2.1.4. Lists . . . . . . . . . . . . . . . . . . . . . .   4
  421.  
  422.           2.1.5. Figures and Tables  . . . . . . . . . . . . . . .   5
  423.  
  424.           2.1.6. Literate Programming  . . . . . . . . . . . . . .   5
  425.  
  426.           2.1.7. Mathematical Formulas . . . . . . . . . . . . . .   6
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                         7
  461.  
  462.  
  463.